home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / ftn / mapw.z / mapw
Text File  |  1998-10-20  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. mmmmaaaappppwwww((((3333GGGG))))                                                              mmmmaaaappppwwww((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      mmmmaaaappppwwww - maps a point on the screen into a line in 3-D world coordinates
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee mmmmaaaappppwwww((((vvvvoooobbbbjjjj,,,, ssssxxxx,,,, ssssyyyy,,,, wwwwxxxx1111,,,,
  13.     ++++    wwwwyyyy1111,,,, wwwwzzzz1111,,,, wwwwxxxx2222,,,, wwwwyyyy2222,,,, wwwwzzzz2222))))
  14.      iiiinnnntttteeeeggggeeeerrrr****4444 vvvvoooobbbbjjjj,,,, ssssxxxx,,,, ssssyyyy
  15.      rrrreeeeaaaallll wwwwxxxx1111,,,, wwwwyyyy1111,,,, wwwwzzzz1111,,,, wwwwxxxx2222,,,, wwwwyyyy2222,,,, wwwwzzzz2222
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  18.      _v_o_b_j   expects a viewing object containing the transformations that map
  19.             the current displayed objects to the screen.
  20.  
  21.      _s_x     expects the x coordinate of the screen point to be mapped.
  22.  
  23.      _s_y     expects the y coordinate of the screen point to be mapped.
  24.  
  25.      _w_x_1    returns the x world coordinate of one endpoint of a line.
  26.  
  27.      _w_y_1    returns the y world coordinate of one endpoint of a line.
  28.  
  29.      _w_z_1    returns the z world coordinate of one endpoint of a line.
  30.  
  31.      _w_x_2    returns the x world coordinate of the remaining endpoint of a
  32.             line.
  33.  
  34.      _w_y_2    returns the y world coordinate of the remaining endpoint of a
  35.             line.
  36.  
  37.      _w_z_2    returns the z world coordinate of the remaining endpoint of a
  38.             line.
  39.  
  40.  
  41. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  42.      mmmmaaaappppwwww takes a pair of 2-D screen coordinates and maps them into 3-D world
  43.      coordinates.  Since the _z coordinate is missing from the screen
  44.      coordinate system, the point becomes a line in world space.  mmmmaaaappppwwww
  45.      computes the inverse mapping from the viewing object, _v_o_b_j.
  46.  
  47.      A viewing object is a graphical object that contains only routines that
  48.      affect the model-view matrix, the projection matrix, or the viewport
  49.      specification.  A correct mapping from screen coordinate to world
  50.      coordinates requires that the viewing object contain the projection and
  51.      viewing transformations that mapped the displayed object from world to
  52.      screen coordinates.
  53.  
  54.      The system returns a world space line, which is computed from (_s_x, _s_y)
  55.      and _v_o_b_j, as two points and stores them in the locations addressed by
  56.      _w_x_1, _w_y_1, _w_z_1 and _w_x_2, _w_y_2, _w_z_2.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmaaaappppwwww((((3333GGGG))))                                                              mmmmaaaappppwwww((((3333GGGG))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      mapw2
  76.  
  77. NNNNOOOOTTTTEEEE
  78.      This routine is available only in immediate mode.
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.